userProfile | NN n/a IE 4 DOM n/a |
The userProfile object reflects numerous pieces of information stored in the browser's user profile for the current user. This object has four methods that: Let you queue requests for individual fields of the profile (items such as name, mailing address, phone numbers, and so on) Display the request dialog that lets users see what you're asking for and disallow specific items or the whole thing Grab the information Clear the request queue Once the information is retrieved (with the user's permission), it can be slipped into form elements (visible or hidden) for submission to the server. Further details are available from Microsoft in the Internet Client Software Developer's Kit. This object's methods are not fully supported in the Macintosh version of Internet Explorer 4. |
addReadRequest( ) | NN n/a IE 4 DOM n/a | |||||||||||||||||||||||||||||||
addReadRequest(attributeName) |
||||||||||||||||||||||||||||||||
Adds a request to inspect a particular user profile attribute to a queue that must be executed separately (via the doReadRequest( ) and getAttribute( ) methods). Items added to the queue are displayed to the user to select which item(s) can be submitted to a server. For multiple attributes, use multiple invocations of the addReadRequest( ) method. | ||||||||||||||||||||||||||||||||
Returned Value None. | ||||||||||||||||||||||||||||||||
Parameters
|
clearRequest( ) | NN n/a IE 4 DOM n/a |
Empties the queue of attribute names to be retrieved. Use this after your script has successfully retrieved the required information. This prepares the queue for the next list. | |
Returned Value None. | |
Parameters None. |
doReadRequest( ) | NN n/a IE 4 DOM n/a | |||||||||||||||||||||||||||||||||||||
doReadRequest(usageCode[, friendlyName[, domain[, path[, expiration]]]]) | ||||||||||||||||||||||||||||||||||||||
Based on the items in the queue, this method inspects the browser to see whether the user has given permission to inspect these attributes in the past. If not (for some or all), the method displays a dialog box (the Profile Assistant window) that lets users turn off the items that should not be exposed to the server. Parameters provide information for the dialog and for maintenance of the permission (similar to the ways that cookies are managed). Only one doReadRequest( ) method is required, regardless of the number of attributes in the queue. |
||||||||||||||||||||||||||||||||||||||
Returned
Value In Win32, the method returns no value, regardless of how the user responds to the Profile Assistant dialog box. On the Macintosh (which does not support this object fully), the method does not display the Profile Assistant dialog box and returns false. |
||||||||||||||||||||||||||||||||||||||
Parameters
|
getAttribute( ) | NN n/a IE 4 DOM n/a | ||
getAttribute(attributeName) | |||
Returns the value of the attribute, provided the user has given permission to do so. If that permission was denied, the method returns null. Use one getAttribute( ) method for each attribute value being retrieved. |
|||
Returned
Value In Win32, the method returns no value, regardless of how the user responds to the Profile Assistant dialog box. On the Macintosh (which does not support this object fully), the method does not display the Profile Assistant dialog box and returns false. |
|||
Parameters
|